From 30d0542309e67a0de005064c43a9abad9dfd927b Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Mon, 18 Mar 2013 08:48:15 -0400
Subject: [PATCH] Add documentation for gtk_window_set_titlebar

---
 docs/reference/gtk/gtk3-sections.txt |  1 +
 gtk/gtk.symbols                      |  1 +
 gtk/gtkwindow.c                      | 15 +++++++++++++++
 gtk/gtkwindow.h                      |  1 +
 4 files changed, 18 insertions(+)

diff --git a/docs/reference/gtk/gtk3-sections.txt b/docs/reference/gtk/gtk3-sections.txt
index 26a6ce6034..77995864ea 100644
--- a/docs/reference/gtk/gtk3-sections.txt
+++ b/docs/reference/gtk/gtk3-sections.txt
@@ -5513,6 +5513,7 @@ gtk_window_get_resize_grip_area
 gtk_window_get_application
 gtk_window_set_application
 gtk_window_set_has_user_ref_count
+gtk_window_set_titlebar
 
 <SUBSECTION Standard>
 GTK_WINDOW
diff --git a/gtk/gtk.symbols b/gtk/gtk.symbols
index 4e2a326b7c..8b2a97a0e1 100644
--- a/gtk/gtk.symbols
+++ b/gtk/gtk.symbols
@@ -4051,6 +4051,7 @@ gtk_window_set_skip_pager_hint
 gtk_window_set_skip_taskbar_hint
 gtk_window_set_startup_id
 gtk_window_set_title
+gtk_window_set_titlebar
 gtk_window_set_transient_for
 gtk_window_set_attached_to
 gtk_window_set_type_hint
diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c
index 09429387b5..21d469725e 100644
--- a/gtk/gtkwindow.c
+++ b/gtk/gtkwindow.c
@@ -3415,6 +3415,21 @@ gtk_window_set_geometry_hints (GtkWindow       *window,
   gtk_widget_queue_resize_no_redraw (GTK_WIDGET (window));
 }
 
+/**
+ * gtk_window_set_titlebar:
+ * @window: a #GtkWindow
+ * @titlebar: the widget to use as titlebar
+ *
+ * Sets a custom titlebar for @window.
+ *
+ * If you set a custom titlebar, GTK+ will do its best to convince
+ * the window manager not to put its own titlebar on the window.
+ * Depending on the system, this function may not work for a window
+ * that is already visible, so you set the titlebar before calling
+ * gtk_widget_show().
+ *
+ * Since: 3.10
+ */
 void
 gtk_window_set_titlebar (GtkWindow *window,
                          GtkWidget *titlebar)
diff --git a/gtk/gtkwindow.h b/gtk/gtkwindow.h
index 836f0a429c..6472a7eacd 100644
--- a/gtk/gtkwindow.h
+++ b/gtk/gtkwindow.h
@@ -348,6 +348,7 @@ gboolean gtk_window_resize_grip_is_visible (GtkWindow    *window);
 gboolean gtk_window_get_resize_grip_area   (GtkWindow    *window,
                                             GdkRectangle *rect);
 
+GDK_AVAILABLE_IN_3_10
 void     gtk_window_set_titlebar           (GtkWindow    *window,
                                             GtkWidget    *titlebar);
 
-- 
2.30.2